# Retrieve segment by ID

Retrieve a segment by ID.

Endpoint: GET /entities/segments/{id}
Version: 1.0.0

## Path parameters:

  - `id` (integer, required)
    Segment ID

## Response 200 fields (application/vnd.treasuredata.v1+json):

  - `data` (any, required)

  - `data.id` (string, required)

  - `data.type` (string, required)
    Enum: "segment-batch"

  - `data.attributes` (object, required)

  - `data.attributes.audienceId` (string, required)

  - `data.attributes.name` (string, required)

  - `data.attributes.description` (string, required)

  - `data.attributes.population` (number, required)

  - `data.attributes.numSyndications` (integer)

  - `data.attributes.rule` (any, required)

  - `data.attributes.rule.conditions` (array, required)

  - `data.attributes.rule.conditions.conditions` (array, required)

  - `data.attributes.rule.conditions.description` (string)

  - `data.attributes.rule.conditions.expr` (string)

  - `data.attributes.rule.conditions.type` (string, required)
    Enum: "Or", "And", "Composite"

  - `data.attributes.rule.expr` (string)

  - `data.attributes.rule.limit` (object)

  - `data.attributes.rule.limit.number` (number, required)

  - `data.attributes.rule.limit.orderColumns` (array)

  - `data.attributes.rule.limit.orderColumns.column` (string, required)

  - `data.attributes.rule.limit.orderColumns.order` (string, required)
    Enum: "ascending", "descending"

  - `data.attributes.rule.limit.orderColumns.type` (string, required)
    Enum: "Column"

  - `data.attributes.rule.limit.type` (string, required)
    Enum: "Count", "Percent"

  - `data.attributes.rule.type` (string, required)
    Enum: "Or", "And", "Composite"

  - `data.attributes.createdAt` (string, required)

  - `data.attributes.updatedAt` (string, required)

  - `data.attributes.countPopulation` (boolean)

  - `data.attributes.segmentInsightDashboardId` (integer)

  - `data.attributes.isEmptyRule` (boolean)

  - `data.relationships` (object, required)

  - `data.relationships.parentFolder` (object)

  - `data.relationships.parentFolder.data` (object)

  - `data.relationships.parentFolder.data.id` (string, required)

  - `data.relationships.parentFolder.data.type` (string, required)
    Enum: "folder-segment"

  - `data.relationships.createdBy` (object)

  - `data.relationships.createdBy.data` (object)

  - `data.relationships.createdBy.data.id` (string, required)

  - `data.relationships.createdBy.data.type` (string, required)
    Enum: "user"

  - `included` (array, required)

  - `included.id` (string, required)

  - `included.type` (string, required)
    Enum: "user"

  - `included.attributes` (object, required)

  - `included.attributes.tdUserId` (string, required)

  - `included.attributes.name` (string, required)